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1. Allgemeines 

Dieses Programm ermOglicht MS-DOS Dateien vom EUMEL aus von Disketten zu 
lesen und auf Disketten zu schreiben. Die Benutzerschnittstelle ist dhnlich der des 
EUMEL- Archivs organisiert. Der Benutzer kommuniziert mit einer Task des 
EUMEL -Systems, nAmlich mit der Task 'DOS'. Diese wickelt dann uber das Archiv- 
laufwerk die Diskettenzugriffe ab. Der Benutzer meldet die MS-DOS Diskette mit 
"reserve ("...", /"DOS")'*^ an und kann dann mit 'list (/"DOS")', 'fetch ("...", /"DOS")', 
'save ("...", /"DOS")' und weiteren Kommandos auf die MS-DOS Diskette zugreifen. 
Fur das Schreiben und Lesen (save, fetch) stehen insgesamt 6 verschiedene 
Betriebsarten zur Verfugung. Man kann in eine Datei im ASCII Code mit und ohne 
Anpassung der Umlaute, im EBCDIC Code Oder ganz ohne Codeumsetzung lesen 
bzw. schreiben. Die Betriebsart selbst wird beim Anmelden der MS-DOS Diskette 
durch den Textparameter des 'reserve' -Kommandos bestimmt. 

Die gleiche Benutzerschnittstelle gilt fur die Kommunikation mit der Task 'DOS HD'. 
Diese Task liest und schreibt aber nicht auf der Diskette, sondern in der MS-DOS 
Partition der Festplatte (falls vorhanden). 



2. Benutzeranleitung 

Im Normalfall will man als Benutzer eine EUMEL -Textdatei auf eine MS-DOS 
Diskette schreiben Oder eine mit z.B. Word -Star erstellte MS - DOS - Textdatei in 
das EUMEL -System einlesen (implementierte Formate siehe Abschnitt 3). 

Lesen einer MS - DOS - Datei: 

reserve ("file ascii german", /"DOS"); 
(♦ MS-DOS-Diskette ins Laufwerk einlegen ♦) 
fetch (filename, /"DOS"); 
release (/"DOS") 
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Schreiben einer MS - DOS - Datei: 

reserve ("file ascii german'', /"DOS"); 
(♦ MS-DOS-Diskette ins Laufwerk einlegen *) 
save (filename, /"DOS"); 
release (/"DOS") 

Sollen statt der Umlaute []{|}\ venA/endet warden, so ist statt "file ascii german" "file 
ascii" einzustellen. Eine genaue Beschreibung aller 6 mOglichen Betriebsarten wird in 
Abschnitt 6 gegeben. Der Dateiname 'file name' unterliegt den im Abschnitt 4 be- 
schriebenen EinschrAnkungen. 



3. Implementierte Formate 

Diese Software ermOglicht das Bearbeiten von MS-DOS Disketten mit Hilfe der Task 
/"DOS" und (falls es sich urn einen MS-DOS fShigen Rechner mit MS-DOS Parti- 
tion auf der Festplatte handelt) das Bearbeiten von Daten in der MS - DOS Partition 
der Platte. 

3.1 Arbeiten mit der Task /"DOS" 

Die Task /"DOS" verwendet das Archivlaufwerk als MS-DOS DatentrSger. Es sind 
alle mit dem IBM -Format der DOS Version 2 kompatiblen Formate fur Disketten 130 
(5.25 Zoll) implementiert, sofern diese 512 Byte groBe Sektoren verwenden und im 
ersten Sektor einen erweiterten BIOS- Parameterblock (BPB) enthalten. Weiterhin 
sind die beiden von IBM verwendeten Formate der DOS Version 1 implementiert 
(ein- bzw. zweiseitig, 40 Spuren a' 8 Sektoren). 

Die einzige Hardwarevoraussetzung besteht darin, daB der Hardwareanpassungs- 
modul (SHard) alle von DOS benutzten Sektoren lesen und schreiben kfinnen muS. 

3.1 Arbeiten mit der Task /"DOS HD" 

Die Task /"DOS HD" verwendet die MS-DOS Partition der Festplatte als Daten- 
trftger (falls eine solche vorhanden ist und das SHard diese ansprechen kann). Hier 
gibt es keine Zugriffsbeschrdnkungen. 
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4. Dateibenennung 

Die Namen fur MS-DOS Dateien unterliegen bestimmten Regeln. Ein Dateiname 
kann aus 

- einem bis acht Zeichen Oder 

- einem bis acht Zeichen gefolgt von einem Punkt und einer Namensenweiterung 
von einem bis drei Zeichen 

bestehen. 

Gultige Zeichen sind 

- die Buchstaben A bis Z 

- die Ziffern 0 bis 9 

- die Sender- und Satzzeichen $ # & @ ! ( ) { } 

Da weitere Sonderzeichen in verschiedenen MS-DOS Versionen in unterschiedlich- 
em Umfang eriaubt sind, ist ihre Verwendung beim Schreiben (save) vom EUMEL aus 
nicht zugelassen. Beim Lesen und LOschen dagegen sind sie eriaubt. 

AuBerdem sind die Buchstaben a - z eriaubt. Diese werden beim Zugriff auf das 
MS-DOS Inhaltsverzeichnis (Directory) in groBe Buchstaben konvertiert. Durch das 
Kommando 'fetch ("Test", /"DOS")' wird also die MS-DOS Datei mit dem Namen 
'TEST' in die EUMEL Datei mit dem Namen 'Test' gelesen; 'save ("test", /"DOS")' 
uberschreibt dann die MS -DOS -Datei 'TEST' (naturlich nach Anfrage). 



5. Beschreibung der Kommandos 

in diesem Abschnitt steht der Begriff Dostask beim Arbeiten mit der Floppy fur die 
Task /"DOS" und beim Arbeiten mit der MS-DOS Partition der Platte fur die Task 
/"DOS HD". Analog steht der Begriff Dosbereich beim Arbeiten mit der Floppy fiir die 
Floppy und beim Arbeiten mit der MS-DOS Partition der Platte fur diese Partition. 

THESAURUS OP ALL (TASK CONST task) 

Wird der 'ALL' - Operator fur die Dostask aufgerufen, so wird ein Thesaurus ge- 
liefert. In diesem Thesaurus sind alle im Dosbereich vorhandenen Dateien einge- 
tragen. Die vorhandenen Unterinhaltsverzeichnisse (Subdirectories) werden nicht 
eingetragen. 
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PROC check (TEXT CONST filename, TASK CONST task) 

Durch Aufruf dieser Prozedur fiir die Dostask wird die Datei 'filename' im Dosbe- 
reich prufgelesen. Es werden nur die mit Daten belegten BlOcke prufgelesen. 
Sollen auch der Eintrage im Inhaltsverzeichnis uberpruft werden, so erreicht man 
dies durch vorheriges neues Anmeiden mit der Prozedur 'reserve'. 



PROC clear (TASK CONST task) 

Durch Aufruf dieser Prozedur fur die Task /"DOS" wird die gesamte Diskette ge- 
I6scht. Mit dieser Prozedur kfinnen nur MS-DOS formatierte Disketten behandelt 
werden. Soil eine Diskette dagegen fur den Gebrauch unter MS-DOS initialisiert 
werden, so ist sie auf einem MS-DOS-Rechner zu formatieren. 

Der Aufruf dieser Prozedur fur die Task /DOS HD" ist aus Sicherheitsgrunden nicht 
eriaubt. 



PROC erase (TEXT CONST filename, TASK CONST task) 

Durch Aufruf dieser Prozedur fur die Dostask wird die Datei 'filename' im Dosbe- 
reich gelOscht. 



BOOL PROC exists (TEXT CONST name, TASK CONST task) 

Wird diese Prozedur fiir die Dostask aufgerufen, so liefert sie 'TRUE', falls eine 
Datei mit dem Namen 'name' im Dosbereich existiert. Andernfalls liefert sie 
'FALSE'. 



PROC fetch (TEXT CONST filename, TASK CONST task) 

Durch Aufruf dieser Prozedur fur die Dostask wird die Datei 'filename' aus dem 
Dosbereich gelesen. Hierbei wird in der beim Anmeiden (reserve ("...", dostask)) 
bestimmten Betriebsart gelesen (siehe Abschnitt 6). 



PROC list (TASK CONST task) 

Wird diese Prozedur fur die Dostask aufgerufen, so werden alle Dateien des 
Inhaltsverzeichnisses und alle Unterverzeichnisse des Dosbereichs aufgelistet. 
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PROC release (TASK CONST task) 

Der Aufruf dieser Prozedur fur die Task Dostask hebt deren Reservierung auf. 
Gieichzeitig wird auch der fur block i/o benutzte Kanal freigegeben, so daB bei 
Benutzung der Task /"DOS" der Archivkanal durch das EUMEL-Archiv wieder 
benutzt warden kann. 

Urn mdglichst effizient arbeiten zu kfinnen, werden Inhaltsverzeichnis und Ket- 
tungsblock des Dosbereichs als Kopie im EUMEL gehalten. Der hierdurch belegte 
Speicher wird beim 'release' wieder freigegeben. Dies ist bei kleinen Systemen 
besonders wichtig. 



PROC reserve (TEXT CONST mode, TASK CONST task) 

Durch Aufruf fur die Dostask werden Operationen mit dem Dosbereich angemel- 
det. Gieichzeitig koppelt sich die Dostask an den entsprechenden Kanal an. 
(/"DOS" an Kanal 31 und /"DOS HD" an Kanal 29). Die Anmeldung wird abgelehnt, 
wenn der fur die MS-DOS Operationen bendtigte Kanal belegt ist (z.B. bei Kanal 
31 durch eine Archiv-Operation). Ahnlich wie beim EUMEL-Archiv bleibt diese 
Reservierung bis 5 Minuten nach dem letzten Zugriff gultig. 

Wird beim Arbeiten mit der Task /"DOS" die MS-DOS Diskette gewechselt, so 
muB erneut 'reserve ("...", /"DOS")' aufgerufen werden. Nur so ist gewShrleistet, 
daB das Inhaltsverzeichnis der neuen Diskette geladen wird. 

Der Text 'mode' gibt die Betriebsart fur das Schreiben und Lesen der Diskette 
sowie den Pfad fur das Bearbeiten von Subdirectories an und nicht wie beim 
EUMEL-Archiv den Diskettennamen. Es gilt folgende Systax: 

modus :[\directory][\directory]...[\directory] 

Hierbei sind die Angaben in eckigen Klammern optional. Wird kein Pfad angege- 
ben, so wird mit dem Hauptdirektory der Diskette gearbeitet. Ansonsten wird mit 
dem Directory gearbeitet. welches durch den hinter dem Doppelpunkt angegeben 
Pfad bezeichnet wird. Als 'modus' kOnnen alle in Abschnitt 6 beschriebenen Be- 
triebsarten verwendet werden. 



PROC save (TEXT CONST filename, TASK CONST task) 

Durch Aufruf dieser Prozedur fur die Dostask wird die Datei 'filename' in den 
Dosbereich geschrieben. Hierbei wird in der beim Anmelden (reserve ("...". 
dostask)) bestimmten Betriebsart geschrieben (siehe Abschnitt 6). 
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6. Die Betriebsarten von 'fetch' und 'save' 



6.1 Betriebsart: file ascii 



fetch ("filename", dostask) 

Die MS-DOS Datei 'filename' wird in die EUMEL-Datei 'filename' kopiert. Dabei 
werden von alien Zeichen nur die niederwertigen 7 Bit gemdB DIN 66 003, ASCII 
Code, Internationale Referenzversion interpretiert. Die Datei wird so aufbereitet, 
daB ein Bearbeiten mit dem EUMEL- Editor mdglich ist. Dies geschieht folgen- 
dermaSen: 

- Alle im EUMEL darstellbaren Zeichen werden auf diese abgebildet. 

- Die Zeichenfolgen CR LF, LF CR, LF, CR (CR = carriage return, LF = line- 
feed) beenden einen Satz in der MS -DOS -Datei. Dementsprechend wird 
eumelseitig die aktuelle Zeile beendet. 

- Das Zeichen FF (form feed) beendet eumelseitig die aktuelle Zeile. AuBerdem 
wird ein Satz mit dem Inhalt ''#page#'' eingefugt. 

- TAB'S (Code 9) werden mit Blanks zur nSchsten 8ter- Position expandiert. 

- 'Ctrl z' in der MS-DOS Datei wird als Dateiende interpretiert. Fehit dieses, 
so wird bis zum letzten Zeichen des letzten Sektors der Datei gelesen. 

- Alle anderen Zeichen mit 0 < = code (zeichen) < = 31 (Steuerzeichen) 
werden durch eine Ersatzdarstellung dargestellt (der Code des Zeichens wird 
als 3 stellige Dezimalzahl eingeschlossen von #- Zeichen dargestellt). 



save ("filename", dostask) 

Die EUMEL-Datei 'filename' wird nach MS-DOS geschrieben. Unter MS-DOS 
wird der ASCII Code, Internationale Referenzversion gemdB DIN 66 003 ven^endet. 
Dies geschieht folgendermaBen: 

- Steht in einer Zeile nur das Kommando '#page#' so wird dieses in ein Sei- 
tenvorschubsteuerzeichen (""12"") umgewandelt. 

- Die EUMEL -spezifischen Druckzeichen (Trenn -, Trenn k, Druck #, ge- 
schutztes Blank) werden in - , k, # und Blank umgesetzt. 

- Alle in der internationalen Referenzversion des ASCII Codes vorhandenen 
Eumel- Zeichen werden auf diese abgebildet. 

- Alle in der internationalen Referenzversion des ASCII Codes nicht vorhande- 
nen Eumel - Zeichen werden durch eine Ersatzdarstellung dargestellt (der 
Code des Zeichens wird als 3 stellige Dezimalzahl eingeschlossen von 
#- Zeichen dargestellt) 
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- Nach jeder Zeile wird 'carriage return' und ' linefeed' angefugt 

- Am Ende der Datei wird 'crti z' angehdngt. 



6.2 Betriebsart: file ascii german 
fetch ("filename", dostask) 

Die MS-DOS Datei 'filename' wird in die EUMEL- Datei 'filename' kopiert. Dabei 
werden von alien Zeichen nur die niederwertigen 7 Bit gem£iB DIN 66 003, ASCII 
Code, deutsche Referenzversion interpretiert. Die Datei wird so aufbereitet, daB ein 
Bearbeiten mit dem EUMEL- Editor mOglich ist. Dies geschieht wie in der Be- 
triebsart 'file ascii', jedoch stehen statt []{}|\ die Umlaute und 6 zur Verfugung. 



save ("filename", dostask) 

Die EUMEL -Datei 'filename' wird nach MS-DOS geschrieben. Unter MS-DOS 
wird der ASCII Code, deutsche Referenzversion gemSB DIN 66 003 verwendet. 
Dies geschieht wie in der Betriebsart 'file ascii', jedoch stehen statt []{}|\ die 
Umlaute zur Verfugung. 



6.3 Betriebsart: file ebcdic 
fetch ("filename", dostask) 

Die MS-DOS Datei 'filename' wird in die EUMEL -Datei 'filename' kopiert. Dabei 
werden alle Zeichen als EBCDIC -Zeichen interpretiert. Die Datei wird so aufberei- 
tet, daB ein Bearbeiten mit dem EUMEL -Editor mOglich ist. Dies geschieht fol- 
gendermaBen: 

- Alle im EUMEL darstellbaren Zeichen werden auf diese abgebildet. 

- Die Zeichenfolgen CR LF, LF CR, CR, LF beenden einen Satz in der 
MS -DOS -Datei. Dementsprechend wird eumelseitig die aktuelle Zeile 
beendet. 

- Das Zeichen FF beendet eumelseitig die aktuelle Zeile. AuBerdem wird ein 
Satz mit dem Inhalt ''#page#" eingefugt. 

- Alle anderen Zeichen werden durch eine Ersatzdarstellung dargestellt (der 
Code des Zeichens wird als 3 stellige Dezimalzahl eingeschlossen von 
#- Zeichen dargestellt). 
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save ("filename", dostask) 

Die EUMEL-Datei 'filename* wird nach MS-DOS geschrieben. Unter MS-DOS 
wird der EBCDIC Code verwendet. Dies geschieht folgendermaBen: 

- Steht in einer Zeile nur das Kommando '#page#', so wird dieses in ein 
Seitenvorschubsteuerzeichen (FF) umgewandelt. 

- Die EUMEL-spezifischen Druckzeichen (Trenn - , Trenn k, Druck #, 
geschutztes Blank) werden in - , k, # und Blank umgesetzt. 

- Alle im EBCDIC Code vorhandenen Eumel-Zeichen werden auf diese abge- 
bildet. 

- Alle im EBCDIC Code nicht vorhandenen Eumel-Zeichen werden durch eine 
Ersatzdarstellung dargestellt (der Code des Zeichens wird als 3 stellige Dezi- 
malzahl eingeschlossen von #-Zeichen dargestellt) 

- Nach jeder Zeile wird 'carriage return' und ' linefeed' angefugt 



6.4 Betriebsart: file transparent 
fetch ("filename", dostask) 

Die MS-DOS Datei 'filename' wird in die EUMEL-Datei 'filename' kopiert. Dabei 
werden von alien Zeichen alle 8 Bit interpretiert. Die Datei wird folgendermaBen 
aufbereitet: 

- Die Zeichenfolgen CR LF, LF CR, CR, LF beenden einen Satz in der 
MS -DOS -Datei. Dementsprechend wird eumelseitig die aktuelle Zeile 
beendet. 

- Das Zeichen FF (form feed) beendet eumelseitig die aktuelle Zeile. AuBerdem 
wird ein Satz mit dem Inhalt '•#page#'' eingefugt. 

Da eine solche Datei noch Steuerzeichen enthalten kann, ist beim Bearbeiten mit 
dem Editor Vorsicht geboten. 



save ("filename", dostask) 

Die EUMEL-Datei 'filename' wird nach MS-DOS geschrieben. Es werden keine 
Codeumsetzungen durchgefuhrt. Lediglich das Kommando *#page#' wird, wenn es 
allein auf einer Zeile steht, durch ein Seitenvorschubsteuerzeichen (FF) ersetzt. 
Welter wird nach jeder Zeile 'carriage return' und 'linefeed' angefugt und am Ende 
der Datei wird 'crti z' angeh^ngt. 
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6.5 Betriebsart: row text 

Diese Betriebsart ist nur fur Programmierer interessant. Sie ist fur die Umsetzung 
exotischer Codes in den EUMEL-Code mittels ELAN - Programmen gedacht. 

fetch ("filename", dostask) 

Die MS-DOS Datei 'filename' wird in einen Datenraum mit folgender Struktur 
kopiert: 

STRUCT (INT benutzte texte, ROW 4000 TEXT datensatz) 

Dabei bekommt der Datenraum den Type 1000. Der Integer 'benutzte texte' gibt 
an, wieviele Elemente des ROW 4000 TEXT benutzt sind. In jedem benutzten 
Element des ROW 4000 TEXT steht der Inhalt einer logischen Gruppe der 
MS-DOS Diskette. (Eine logische Gruppe umfaBt bei einer einseitig beschriebe- 
nen MS-DOS Diskette 512 Byte und bei einer zweiseitig beschriebenen 1024 bzw. 
2048 Byte). In dieser Betriebsart werden keine Zeichen der MS-DOS Datei kon- 
vertiert Oder interpretiert, so daB also auch alle Steuerzeichen erhalten bleiben. 



save ("filename", dostask) 

Hier bezeichnet 'filename' einen Datenraum der Struktur: 

STRUCT (INT benutzte texte, ROW 4000 TEXT datensatz) 
Dieser Datenraum muB den Type 1000 haben. 

Es werden die benutzten Texte (1 bis benutzte texte) aneinandergehangt und ohne 
irgendwelche Konvertierungen bzw. Interpretationen als MS-DOS Datei 'filename' 
geschrieben. Dies bedeutet, daB die Texte auch alle von MS-DOS benOtigten 
Steuerzeichen (z.B. 'Ctrl z' als Dateiendekennzeichen) enthalten mussen. 
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6.6 Betriebsart: ds 

Diese Betriebsart ist nur fur den Programmierer interessant. Sie ermdglicht das 
Abbilden von Datenstrukturen zwischen MS-DOS und EUMEL. 

fetch ("filename", doetaek) 

Die MS-DOS Datei 'filename' wird blockweise in den Datenraum 'filename' ko- 
piert. Hierbei wird der erste Block der MS-DOS Datei in die 2. Seite des Daten- 
raums kopiert. (Die 2. Seite eines Datenraums ist die erste, die von einer Daten- 
struktur vol! uberdeckt werden kann). 



save ("filename", dostask) 

Der Datenraum 'filename' wird ab seiner 2. Seite in die MS-DOS Datei 'filename' 
geschrieben. Hierbei werden alle Seiten des Datenraums (auch die nicht allokier- 
ten) bis einschlieBlich der letzten allokierten Datenraumseite geschrieben. 
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7. Installation 

Die Software zur Generierung der Tasks /"DOS" und /"DOS HD" wird auf getrennten 
EUMEL- Archiven ausgeliefert. Bitte mischen Sie nie die einzelnen Dateien unter- 
einander, da die Dateien trotz gleicher Namen unterschiedliche Inhalte haben. 

7.1 Installation der Task /"DOS" 



7.1.1 Installation im Multi-User 

Die Software muB in einer privilegierten Task mit dem Namen 'DOS' installiert wer- 
den. Dies geschieht folgendermaBen: 

begin ("DOS", "SYSUR") 
archive ("dos"); 

fetch ("dos inserter", archive); 
run ("dos inserter") 

Danach stehen die Prozeduren 

PROC dos manager 

PROC dos manager (INT CONST channel) 

zur Verfugung. Beide Prozeduren machen die aufrufende Task zur Kommunikations- 
task fur das Schreiben und Lesen von MS-DOS Disketten. Die erste benutzt dazu 
den Archivkanal (Kanal 31), bei der zweiten ist der Kanal uber den Parameter ein- 
stellbar. Eine dieser Prozeduren muB jetzt aufgerufen werden. 
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7.1.2. Installation im Single - 

Die Software wird im Monitor ('gib Kommando' 
installiert: 

archive ("dos"); 
fetch ("dos inserter", archive); 
run ("dos inserter") 

Fur das Schreiben und Lesen von MS-DOS Disketten wird der Archivkanal (Kanal 
31) benutzt. 



7.2 Installation der Task /"DOS HD" 

Die Software muB in einer privilegierten Task mit dem Namen 'DOS HD' installiert 
werden. Dies geschieht foigendermaBen: 

begin ("DOS HD", "SYSUR") 
archive ("dos"); 

fetch ("dos hd inserter", archive); 
run ("dos hd inserter") 

Danach steht die Prozedur 

PROC dos manager 

zur Verfugung. Sie macht die aufrufende Task zur Kommunikationstask fur das 
Schreiben und Lesen in der MS-DOS Partition der Platte. Sie benutzt dazu den 
Kanal 29, der, wie im Portierungshandbuch fur den 8086 beschrieben, implementiert 
sein muB. 



-User 

- Modus) durch folgende Kommandos 



